<HTML>
<HEAD>
 <title>DAS registry server - local installation</title>
<link rel="stylesheet" type="text/css" href="http://www.sanger.ac.uk/stylesheets/stylesheet.css" />
 <link href="xmlverbatim.css" rel="stylesheet" type="text/css">
</HEAD>

<BODY>
<!-- the sanger default header -->
<%@ include file="sangerheader.jsp" %>

<jsp:include page="sangertitle.jsp" >
        <jsp:param name="title" value="local installation of DAS registration service" />
</jsp:include>

<%@ include file="sangertablestart.jsp" %>

<table border="0" width="550">
<tr><td>

<p> Sometimes people require a local installation of the DAS
registration service, e.g. because they are behind a firewall and have
DAS sources that are not public available. A local DAS registation
service can keep track of these sources. Still DAS clients only need
to contact to a single DAS registration service, since the
registration can be configured to contact "parent" services.
  </p>


<h2>How to get a local copy of a DAS registration service</h2>

Get the following files:
<ul>
<li><a href="dasregistry.war">dasregistry.war</a>
<li><a href="das_registry.sql">das_registry.sql</a>
</ul>

Create mysql database with the SQL commands provided in
<b>das_registry.sql</b>.  copy the <b>axis.war</b> and
<b>dasregistry.war</b> files into your <a href="">tomcat</a> or <a
href="">resin</a> installations <i>webapp</i> directory. Restart the
server. Proceed to
<pre>$TOMCAT/webapps/axis/WEB-INF/classes/dasregistrycfg.xml</pre>
change the config so it fits to your setup. Do the same for
<pre>$TOMCAT/webapps/dasregistry/WEB-INF/classes/dasregistrycfg.xml</pre>.
Restart your server again. Pointing your browser to 
<pre>http://yourserver:yourport/dasregistry</pre> should display the start page of the das registration service!.



<h2>The dasregistrycfg.xml file</h2>
A typical configuration file looks like this:
<pre>

<div class="xmlverb-default">&lt;!--<span class="xmlverb-comment">&nbsp;config&nbsp;file&nbsp;for&nbsp;DAS&nbsp;registration&nbsp;server&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<br>
&lt;!--<span class="xmlverb-comment">&nbsp;@author&nbsp;Andreas&nbsp;Prlic&nbsp;ap3 at sanger.ac.uk&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<br>
&lt;!--<span class="xmlverb-comment">&nbsp;@date&nbsp;04.11.2004&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<br>
&lt;<span class="xmlverb-element-name">dasregistry</span><span class="xmlverb-ns-name"> xmlns</span>="<span class="xmlverb-ns-uri">http://www.efamily.co.uk</span>"&gt;<span class="xmlverb-text"><br>
<br>
</span>&lt;!--<span class="xmlverb-comment">&nbsp;DasRegistrySql&nbsp;server&nbsp;related&nbsp;parameters&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;configure&nbsp;the&nbsp;registry&nbsp;server&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">sendmailhost</span> <span class="xmlverb-attr-name">name</span>="<span class="xmlverb-attr-content">localhost</span>" /&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">serveradmin</span> <span class="xmlverb-attr-name">email</span>="<span class="xmlverb-attr-content">ap3 at sanger.ac.uk</span>" /&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">dbconn</span> <span class="xmlverb-attr-name">connstring</span>="<span class="xmlverb-attr-content">jdbc:mysql://servername:3306/das_registry</span>" <span class="xmlverb-attr-name">user</span>="<span class="xmlverb-attr-content">xxxxxx</span>" <span class="xmlverb-attr-name">password</span>="<span class="xmlverb-attr-content">xxxxxx</span>" <span class="xmlverb-attr-name">dbdriver</span>="<span class="xmlverb-attr-content">com.mysql.jdbc.Driver</span>" /&gt;<span class="xmlverb-text"><br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;defines&nbsp;how&nbsp;often&nbsp;a&nbsp;reminder&nbsp;email&nbsp;for&nbsp;the&nbsp;password-key&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;can&nbsp;be&nbsp;requested&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;1000&nbsp;milli&nbsp;sec&nbsp;*&nbsp;60&nbsp;sec&nbsp;*&nbsp;60&nbsp;min&nbsp;=&nbsp;3600000&nbsp;=&nbsp;1&nbsp;/&nbsp;hour&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">remindermail</span> <span class="xmlverb-attr-name">frequency</span>="<span class="xmlverb-attr-content">3600000</span>" /&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;if&nbsp;this&nbsp;registry&nbsp;is&nbsp;a&nbsp;"local"&nbsp;server,&nbsp;contact&nbsp;"parent"&nbsp;-&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;public&nbsp;registry&nbsp;as&nbsp;well.&nbsp;das&nbsp;clients&nbsp;only&nbsp;need&nbsp;to&nbsp;contact&nbsp;1&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;registry,&nbsp;not&nbsp;several&nbsp;to&nbsp;get&nbsp;all&nbsp;available&nbsp;services.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">parentregistry</span> <span class="xmlverb-attr-name">location</span>="<span class="xmlverb-attr-content">http://servlet.sanger.ac.uk:8080/axis/services/das_registry</span>" /&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br>
</span>&lt;!--<span class="xmlverb-comment">&nbsp;DasRegistryAxisClient&nbsp;related&nbsp;parameters&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;!--<span class="xmlverb-comment">&nbsp;location&nbsp;of&nbsp;the&nbsp;webservice&nbsp;for&nbsp;the&nbsp;client&nbsp;to&nbsp;call&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">webservice</span> <span class="xmlverb-attr-name">location</span>="<span class="xmlverb-attr-content">http://127.0.0.1:8080/axis/services/das_registry</span>" /&gt;<span class="xmlverb-text"><br>
<br>
</span>&lt;!--<span class="xmlverb-comment">&nbsp;general&nbsp;config,&nbsp;should&nbsp;not&nbsp;be&nbsp;needed&nbsp;to&nbsp;change...&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
</span>&lt;!--<span class="xmlverb-comment">&nbsp;required&nbsp;by&nbsp;Axis&nbsp;client,&nbsp;and&nbsp;for&nbsp;deployment&nbsp;of&nbsp;webservice&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
</span>&lt;!--<span class="xmlverb-comment">&nbsp;if&nbsp;you&nbsp;change&nbsp;this,&nbsp;also&nbsp;change&nbsp;deploy.wsdd&nbsp;and&nbsp;re-deploy!&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>--&gt;<span class="xmlverb-text"><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">dasdirectory</span> <span class="xmlverb-attr-name">name</span>="<span class="xmlverb-attr-content">das:das_directory</span>" /&gt;<span class="xmlverb-text">&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>&lt;<span class="xmlverb-element-name">jspconfig</span> <span class="xmlverb-attr-name">dassource</span>="<span class="xmlverb-attr-content">http://localhost/das_directory</span>" /&gt;<span class="xmlverb-text"><br>
<br>
</span>&lt;/<span class="xmlverb-element-name">dasregistry</span>&gt;<br>
</div>

</pre>


<h2>Where can I check out the source code of the registration service?</h2>

<p> You do not need to check out the source code to obtain a local
installation. If you are still curious to check it out, the code is
available under the 
<a href="http://www.gnu.org/copyleft/lesser.html">LGPL</a>.</p>

<p>The source code of the Registration service is available 
using <a href="http://subversion.tigris.org/">Subversion</a> from 
<a href="http://www.derkholm.net/svn/repos/dasregistry/trunk/">http://www.derkholm.net/svn/repos/dasregistry/trunk/</a>.
</p>


</td></tr>
</table>
<%@ include file="sangertableend.jsp" %>


<%@ include file="sangerfooter.jsp" %>


  </body>
</html>
